home *** CD-ROM | disk | FTP | other *** search
/ Reverse Code Engineering RCE CD +sandman 2000 / ReverseCodeEngineeringRceCdsandman2000.iso / RCE / Softice Tuts / si-ug-chapter02.rtf < prev    next >
Text File  |  2000-05-25  |  8KB  |  173 lines
  1. CHAPTER 2 - Getting Started
  2.  
  3.      02.01 The Diskettes
  4.      02.02 Loading Soft-ICE
  5.      02.02.01 Loading Without Extended Memory
  6.      02.02.02 Loading With Extended Memory
  7.      02.02.03 Configuring Soft-ICE for a Customized Installation
  8.      02.03 Unloading Soft-ICE
  9.      02.04 Reloading Soft-ICE
  10.  
  11. 02.01 The Diskettes
  12.  
  13.      Soft-ICE comes on either a 5 1/4" diskette or a 3 1/2" diskette.
  14.  
  15.      When you run Soft-ICE, the name of the person that your copy of
  16.      Soft-ICE is licensed to is displayed on the screen as a deterrent to
  17.      software pirates. The Soft-ICE diskette is not physically
  18.      copy-protected for your convenience. For our convenience, we
  19.      appreciate your high regard for our licensing agreement. It is
  20.      important to make a duplicate copy to be used only for backup in case
  21.      the original diskette is damaged.
  22.  
  23.      A directory of a Soft-ICE diskette will show the following files:
  24.  
  25.       S-ICE.EXE    is the Soft-ICE program.
  26.       S-ICE.DAT    is the Soft-ICE initialization file.
  27.       LDR.EXE      is the Soft-ICE program and symbol file loader.
  28.       MSYM.EXE     is the Soft-ICE symbol file creation program.
  29.  
  30.       EMMSETUP.EXE is a program that allows you to customize the way your
  31.                    system uses expanded memory.
  32.       UPTIME.EXE   sets the time to that of the real time clock.
  33.  
  34.       README.SI    is a text file containing information about Soft-ICE
  35.                    that did not make it into this manual.
  36.  
  37.       SAMPLE.EXE   is a short demonstration program that is used with the
  38.                    tutorial.
  39.  
  40.       SAMPLE.ASM   is the assembly language source file for the
  41.                    demonstration program.
  42.       SAMPLE.SYM   is the symbol file for the demonstration program.
  43.  
  44. 02.02 Loading Soft-ICE
  45.  
  46.      Before running Soft-ICE, copy all of the files on the distribution
  47.      diskette to your hard disk.
  48.  
  49.      These files should be placed in a directory that is accessible through
  50.      your alternate path list.
  51.  
  52.      S-ICE.EXE can be loaded as a device driver in CONFIG.SYS or can be run
  53.      as a program from the command line. To use many of Soft-ICE's
  54.      features, S- ICE.EXE must be loaded as a device driver in CONFIG.SYS.
  55.  
  56.      Note : If you do not have extended memory, Soft-ICE can NOT loaded as
  57.      a device driver. Instead, it must be run from the DOS prompt.
  58.  
  59. 02.02.01 Loading Without Extended Memory
  60.  
  61.      When no extended memory is present, Soft-ICE loads it at the highest
  62.      memory location possible. The memory used by Soft-ICE is then 'mapped
  63.      out', making it invisible to DOS programs. Since the total memory
  64.      visible to DOS its programs is less after Soft-ICE loads, it is
  65.      recommended that you load Soft-ICE before any TSR's or control
  66.      programs.
  67.  
  68.      If you do not have extended memory, simply enter: S-ICE
  69.  
  70. 02.02.02 Loading With Extended Memory
  71.  
  72.      Loading Soft-ICE with extended memory can be done in one of two ways:
  73.  
  74.      1. Install S-ICE,EXE as a driver in CONFIG,SYS, This method is
  75.      necessary if you will be using one the following capabilities:
  76.  
  77.         * Sharing memory with program that use extended memory by using ROM
  78.           BIOS calls (VDISK.SYS, RAMDRIVE.SYS, HIMEM.SYS, cache programs,
  79.           etc.)
  80.         * Using Soft-ICE's EMM 4,0 capability,
  81.         * Using Soft-ICE for symbolic or source level debugging.
  82.         * Using back trace ranges.
  83.         * Using Soft-ICE with other Nu-Mega products such as Magic CV.
  84.  
  85.      When loaded as a driver, Soft-ICE allocates a portion of extended
  86.      memory for itself and its associated components so there can be no
  87.      memory conflicts. S-ICE.EXE must be loaded in CONFIG.SYS before any
  88.      other driver that allocates extended memory is loaded (e.g.,
  89.      VDISK.SYS, RAMDRIVE.SYS). Generally Soft-ICE works best if it is the
  90.      first loadable device driver installed in CONFIG.SYS. For users that
  91.      are new to Soft-ICE it is advisable to load Soft-ICE as the first
  92.      driver in CONFIG.SYS with the following statement:
  93.  
  94.      device=drive:\path\S-ICE.EXE /SYM 50
  95.  
  96.      Drive and path specify the directory where S-ICE.EXE is located. This
  97.      statement will load Soft-ICE at system initialization and will be
  98.      adequate for the tutorial. However, Soft-ICE will not be installed for
  99.      some of its more powerful features such as EMM 4.0. You can
  100.      reconfigure Soft-ICE with those features enabled after you have
  101.      experimented a bit. If you already have experience with Soft-ICE or
  102.      would like to set up Soft-ICE with those features immediately, please
  103.      read chapter 6 (Soft-ICE Initialization Options).
  104.  
  105.      Caution : When installing any new device driver for the first time on
  106.      your system, it is advisable to have a boot diskette available This
  107.      precautionary measure is for the unlikely event that The default setup
  108.      of the device driver is not compatible with your system.
  109.  
  110.      If you are not sure how to edit your CONFIG.SYS file, refer to your
  111.      system user's guide or your text editor user's guide for instructions.
  112.      After you have modified your CONFIG.SYS file, you must reboot your
  113.      system to have the changes take effect.
  114.  
  115.      2. Run Soft-ICE from the DOS Prompt by typing S-ICE. Before actually
  116.      loading, Soft-ICE will display a loading message and prompt. To
  117.      prevent this prompt, place the word EXTENDED in the S-ICE.DAT file.
  118.      See section 6.4 for more information on the S-ICE.DAT file. Using this
  119.      method, S-ICE.EXE is automatically loaded into the top of extended
  120.      memory, whether or not anything else is already there. If you know you
  121.      will not have any other programs using extended memory, this method is
  122.      acceptable. When loaded with this method, Soft-ICE occupies ZERO bytes
  123.      of conventional memory. The command you use is:
  124.  
  125.      S-ICE
  126.  
  127.      Notes : You can NOT enable all of Soft-ICE's features when Loading
  128.      from the command line. If you will be using Soft-ICE as a stand-alone
  129.      debugger, it is recommended to Load Soft-ICE from CONFIG.SYS.
  130.  
  131.      If you want to load Soft-ICE as a device driver, but don't want
  132.      Soft-ICE to be resident all of the time, you should use the /UN
  133.      loading switch. Refer to section 6.3.1 for more information.
  134.  
  135. 02.02.03 Configuring Soft-ICE for a Customized Installation
  136.  
  137.      You can customize Soft-ICE with Soft-ICE loading switches in
  138.      CONFIG.SYS and with the Soft-ICE initialization file S-ICE.DAT. The
  139.      CONFIG.SYS loading switches allow you to customize how the extended
  140.      memory will be reserved by Soft-ICE. The initialization file S-ICE.DAT
  141.      allows you to specify configuration options, assign commands to
  142.      function keys, and define an auto-start string. An auto-start string
  143.      is used to execute a series of commands that you use every time you
  144.      install Soft-ICE. for more information about customizing Soft-ICE,
  145.      refer to chapter 6.
  146.  
  147. 02.03 Unloading Soft-ICE
  148.  
  149.      Occasionally you may need to unload Soft-ICE. A typical reason for
  150.      unloading Soft-ICE is to run a program that uses 80286 or 80386
  151.      protected mode instructions. To unload Soft-ICE, enter:
  152.  
  153.      S-ICE /U
  154.  
  155.      This command places the machine back in real address mode. If Soft-ICE
  156.      was initially loaded from CONFIG.SYS When the memory is still reserved
  157.      for Soft-ICE and can not be used by other software. If Soft-ICE was
  158.      initially loaded from the command line, unloading frees up the memory
  159.      consumed by S- ICE.EXE.
  160.  
  161.      Caution : If you have any backfilled memory in your system, or if
  162.      expanded memory is currently being used, unloading Soft-ICE could
  163.      crash your system.
  164.  
  165. 02.04 Reloading Soft-ICE
  166.  
  167.      Soft-ICE can be re-loaded at any time even if it had initially been
  168.      loaded in CONFIG.SYS. If Soft-ICE had initially been loaded in
  169.      CONFIG.SYS then the original configuration options (EMM 4.0, symbols
  170.      and source...) are still in effect. To reload Soft-ICE, enter:
  171.  
  172.      S-ICE
  173.